home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 September / Macworld (1998-09).dmg / Shareware World / Info / For Developers / Script Tools 1.3.6 / Read Me First < prev    next >
Text File  |  1996-10-29  |  8KB  |  187 lines
  1.                               Script Tools 1.3.6
  2.                              Copyright © 1993-1996
  3.                       Mark Alldritt All Rights Reserved
  4.  
  5. This package contains a series of AppleScript additions which add functionality
  6. to the AppleScript language. 
  7.  
  8.     Choose Folder           This command presents a standard file selection
  9.                             dialog which allows the user to select a folder.
  10.  
  11.     Choose New File         This command presents a standard file selection
  12.                             dialog permitting the user to name a new file.
  13.  
  14.     Choose Several Files    This command presents a modified standard file
  15.                             selection dialog box allowing the user to choose
  16.                             several files at one time.
  17.  
  18.     Choose Several Folders  This command is similar to Choose Several Files
  19.                             except that it permits the selection of folders
  20.                             instead of files.
  21.  
  22.     Get Default Folder
  23.     Set Default Folder      These two commands allow your scripts to get and
  24.                             set the default folder and volume used in Choose
  25.                             File and Folder commands.
  26.  
  27.     Shutdown                Shuts down and optionally restarts the Macintosh
  28.  
  29.     Compile Regular Expression
  30.     Match Regular Expression
  31.     Substitute Regular Expression
  32.                             These three commands allow you to perform text
  33.                             pattern matching operations within AppleScript.
  34.  
  35.     openFile, closeFile, createFile, createFolder, deleteFile
  36.     renameFile, exchangeFile, moveFile
  37.     readFile, writeFile, writeString
  38.     getFileLength, lengthenFile
  39.     getFilePosition, positionFile
  40.     changeFileOwner
  41.                             This series of commands allows your AppleScript
  42.                             scripts to manipulate files.
  43.  
  44.     List Processes, Get Process,
  45.     Get Foreground Process,
  46.     Get Current Process        This series of commands allows you write scripts
  47.                             that manipulate running applications.
  48.                             
  49.     List Screens            Obtains a list of the display screens attached
  50.                             to the Macintosh.
  51.  
  52.     Speak, List Voices, Get Voice
  53.                             This series of commands allows you to write
  54.                             AppleScript scripts which use the Apple Speech
  55.                             Manager to say text messages.
  56.  
  57.     Get Gestalt             Accesses Gestalt information
  58.  
  59. The package also contains some example AppleScript scripts which illustrate
  60. the use of these commands.
  61.  
  62.  
  63. Requirements:
  64.  
  65. You must have System 7 or later and AppleScript 1.0 or later installed on your
  66. Macintosh to make use of the software in this package.  A Word Processor 
  67. capable of reading MS Word 5 format files is required to display the
  68. documentation (you can also use the Open Dictionary command in the AppleScript
  69. Script Editor to view a breif descrition of each Script Tools command).
  70.     Apple's Speech Manager is required to use the Speak, List Voices, and Get
  71. Voice commands.
  72.  
  73.  
  74.     * * *  This package does NOT contain the AppleScript software  * * *
  75.     * * *  This package does NOT contain the Speech Manager software * * *
  76.  
  77.  
  78. Using & Copying Script Tools:
  79.  
  80. Script Tools is freeware for personal use.  Please feel free to distribute
  81. Script Tools to friends and colleagues. However, Script Tools may not appear
  82. as part of any promotional offer or commercial product without the author's
  83. expressed written permission.  Commercial re-distrbution licences are available
  84. at a modest price through Late Night Software Ltd.
  85.     When distributing Script Tools, please distribute the entire package as you
  86. received it.  
  87.  
  88.  
  89. Installation:
  90.  
  91. To install Script Tools copy the contents of the Additions folder to the
  92. Scripting Additions folder within the Extensions folder in your System Folder.
  93.  
  94.  
  95. Upgrading:
  96.  
  97. Script Tools 1.3 introduces changes which will effect your existing scripts.
  98. The definition of the reply record returned by the Choose New File command has
  99. been changed.  The name returned field has been changed to filename returned.
  100. This change was made to avoid terminology conflicts with StuffIt Deluxe.
  101.  
  102.  
  103. Version History:
  104.  
  105. Version 1.3.6 October 29, 1996
  106. - Corrected an oversight by including the File IO scripting addition from the
  107.   commercial LNS Scripting Additions package.  This version of File IO changes
  108.   the names of all the commands to avoid terminology conflicts with the word
  109.   file.
  110.  
  111. Version 1.3.5 November 23, 1995
  112. - Added "starting at" parameter to all choose commands in the Choose Files
  113.   & Folders scripting addition.  This allows System 7.5 users to indicate
  114.   an initial folder for all file and folder prompts.
  115. - Reinstanted the choose folder command as "LNS choose folder" since it now
  116.   offers more functionality than Apple's choose folder command
  117. - Corrected a problem with the Processes scripting addition which prevented
  118.   the use of the List Processes, Get Front Process and Get Current Process
  119.   commands in the Script Editor (it has always worked in Script Debugger).
  120.  
  121. Version 1.3.4 September 20, 1995
  122. - Released updated versions of the Choose Files & Folders, Processes, List
  123.   Screens and Regular Expressions additions.  These updates come from the
  124.   commercial version of Script Tools (known as the Late Night Software
  125.   Scripting Additions), and correct a number of bugs.  There are also a
  126.   small number of enhancements to the Regular Expressions scripting
  127.   addition.
  128. - The Choose Folder command has been removed to avoid confusion with the
  129.   Choose Folder command provided by Apple with AppleScript 1.1.  Note that
  130.   the Choose Folder event handler is still present, but the dictionary
  131.   entry has been removed.  This means that your existing scripts will
  132.   continue to compile and run, but the command will be displayed as
  133.   «event ScTlstdD».
  134.  
  135. Version 1.3.3 Never Released
  136.  
  137. Version 1.3.2 October 7, 1994
  138. - Corrected an error in the Substitute Regular Expression example presented
  139.   in the Script Tools Reference.
  140.  
  141. Version 1.3.1 May 1994
  142. - Corrected a memory management problem in the Regular Expressions Addition
  143. - A problem with the Speak command where it would speak the only the first
  144.   255 characters of any string passed to it has been corrected.
  145. - Updated me E-mail address
  146.  
  147. Version 1.3 September 1993
  148. - Addition of the Create Folder command
  149. - Change terminology for the Choose New File command to avoid a conflict with
  150.   StuffIt Deluxe
  151.  
  152. Version 1.2 September 1993
  153. - Addition of the Speak, List Voices, Get Voice, Get Gestalt, Rename File,
  154.   Exchange File, Move File, List Processes, Get Process, Get Current Process,
  155.   Get Foreground Process and List Screens commands
  156. - Corrected a bug in the Create File command which limited path names to 63
  157.   characters.  The limit is now 255 characters
  158. - New example scripts for some of the new commands
  159. - Addition of the gestalt Selector Lib file which defines all the Gestalt
  160.   selectors documented in Inside Mac VI
  161. - Updated documentation now describes all the ScriptTools commands
  162.  
  163. Version 1.1 July 1993
  164. - Addition of the Shutdown, Regular Expression and File IO Additions to the
  165.   package
  166. - Addition of new example scripts
  167.  
  168. Version 1.0 June 1993
  169. - First public release of Script Tools
  170.  
  171.  
  172. Contact Information:
  173.  
  174. Please send all registrations, comments, questions or suggestions to me at
  175. the following address:
  176.  
  177.     Mark Alldritt
  178.     Late Night Software Ltd.
  179.     1571 Deep Cove Road
  180.     North Vancouver, B.C.
  181.     CANADA  V7G-1S4
  182.     
  183.     Voice:    (604) 929-5578
  184.     FAX:    (604) 929-4961
  185.     E-Mail: alldritt@wimsey.com
  186.     WWW:    http://www.latenightsw.com/
  187.